home *** CD-ROM | disk | FTP | other *** search
/ Chip 1999 March / CHIP Turkiye Mart 1999.iso / 101 / data / dir size33 / readme.txt < prev    next >
Text File  |  1999-01-14  |  19KB  |  440 lines
  1. DIRSIZE v3.3 - Disk usage and wastage in a directory tree
  2. =========================================================
  3.  
  4. Copyright (c) 1993-8 Simon A Carter for Crystal Software
  5.  
  6. DirSize is SHAREWARE and may be trialed for a period of 30 days. After
  7. this time you must either purchase the registered version (for $15) or
  8. cease using the shareware version.
  9.  
  10. Please register your USAGE of DirSize by sending email to
  11. launch@ozemail.com.au, with your name and address, the version of DirSize
  12. you are using and any relevant comments or suggestions. By registering
  13. DirSize we can inform you of updates or improvements and let you know when
  14. the next version is released.
  15.  
  16. If you like and use DirSize, how about linking to our Web site (see
  17. below)?
  18.  
  19. Please read the file ORDER.TXT for other registration options.
  20.  
  21.  
  22. Online Web Registration at Albert's Ambry
  23. =========================================
  24. The registered version of DirSize can be purchased and received
  25. immediately on the Internet, eliminating shipping and handling costs.
  26.  
  27. Direct URL: http://secure.alberts.com/P?Product=625&Source=AuthProg
  28.  
  29. OR go to
  30.  
  31.   http://www.alberts.com
  32.  
  33. and search for: DirSize
  34.  
  35. Click on the "Buy it" hotlink to register DirSize.
  36.  
  37.  
  38. Contact Information
  39. ===================
  40. We are always happy to hear your comments! If you use and like DirSize, or
  41. have any suggestions for improvements, please drop us a line! Other user's
  42. suggestions have made it what it is today.
  43.  
  44. Email:      launch@ozemail.com.au
  45.   WWW:      http://www.ozemail.com.au/~launch
  46.   Fax:      +61 (3) 9800-3078
  47. Voice:      +61 (3) 9888-3104. After hours number. Please leave a
  48.            contact name, number and time, and we will try to get back
  49.            to you within 24 hours.
  50.  Mail:      Simon Carter
  51.            Crystal Software
  52.            2 / 9 Woodbine Court
  53.            Wantirna
  54.            Victoria 3152
  55.            AUSTRALIA.
  56.  
  57.  
  58. Benefits
  59. ========
  60.  
  61. DirSize shows you how much disk space is used and wasted in each
  62. directory.
  63.  
  64. Its uses include:
  65.  
  66.     *   Finding space hogs on a network
  67.     *   Finding multiple copies of a single application on a server
  68.     *   Finding which directories could be archived to save space
  69.         (typically those that contain lots of small files)
  70.     *   Finding where most of the disk space is used
  71.     *   Finding applications to remove before installing a new one
  72.     *   Previewing the benefits of a smaller cluster size
  73.     *   Generating daily, weekly or monthly reports showing how the disk
  74.         space distribution has changed. You can easily generate tab- or
  75.         comma-delimited output to feed directly into your favourite
  76.         spreadsheet for further analysis
  77.     *   Showing you the complete directory tree
  78.  
  79. On large hard disks up to 1/4 of the total drive space is wasted! DirSize
  80. will show you where.
  81.  
  82. It runs under DOS, Windows 3.x, 95, 98 and NT, and supports long filenames
  83. under Windows 95, 98 and NT.
  84.  
  85.  
  86. Features
  87. ========
  88.  
  89.     *   Summary statistics for multi-level directories. This is very
  90.         useful for finding the complete size of applications before
  91.         deletion or backup.
  92.     *   Displays Windows 95/NT long filenames.
  93.     *   Supports international thousands separators.
  94.     *   The directories to be displayed can be limited by their size or
  95.         depth; very useful for eliminating unnecessary detail.
  96.     *   For the selected drive, displays actual cluster size, free
  97.         space, used space and capacity.
  98.     *   For each directory tree specified, displays cluster size (user-
  99.         selectable), total space used and wastage (as a percentage or as
  100.         a total).
  101.     *   For each directory displayed, shows total space, wasted space
  102.         (as a percentage or as a total), and if it has subdirectories,
  103.         the total space used by the directory and all of its
  104.         subdirectories.
  105.     *   Shows wasted space for a given cluster size - optimise your
  106.         cluster size before repartitioning your hard disk.
  107.     *   Rounds up file sizes to the cluster size for the most accurate
  108.         size information.
  109.     *   Size/wastage information includes the size of directories
  110.         themselves.
  111.     *   Full scrolling support in either direction. Disabled
  112.         automatically if output is redirected.
  113.     *   Output can be redirected to a file or to the printer or into
  114.         another program.
  115.     *   The characters used to draw the directory tree can be changed
  116.         from DOS extended ASCII characters to standard ASCII characters
  117.         for other operating systems.
  118.     *   Comma-delimited and tab-delimited output formats for easy
  119.         importing into databases, spreadsheets or word processors for
  120.         further analysis or specialised printing.
  121.     *   Directory sorting by name, total or local size, wastage or file
  122.         count.
  123.     *   Future proof - directory sizes up to 99 GB are catered for.
  124.     *   Progress indicator as it accumulates file information.
  125.  
  126.  
  127. Installation
  128. ============
  129.  
  130. Just copy DIRSIZE.EXE to a directory in your path, for example, to C:\DOS.
  131. To find out the directories in your path, type
  132.  
  133.    c:\> path    [Enter]
  134.  
  135.  
  136. How to use DirSize
  137. ==================
  138.  
  139. Typing
  140.  
  141.    dirsize -?   [Enter]
  142.  
  143. on its own will display usage information.
  144.  
  145. Usage:
  146.    dirsize [options] [directory] [options]
  147.  
  148. Where [options] is zero or more of:
  149. [directory]   Default: Current path
  150.               
  151.               The directory to process. This may be a UNC path
  152.               (\\computer_name\share_name\path). Directory names with
  153.               special characters such as spaces must be entered with
  154.               double quotes e.g.
  155.               
  156.               c:\> dirsize "Program Files"   [Enter]
  157.               
  158. -sort=        Default: name
  159.  [name  |     
  160.   local |     Specifies the sort order:
  161.   total |     
  162.   waste |       Name - sort by directory name in alphabetical order.
  163.   files |       
  164.   none          Local - sort by local size, largest first.
  165.  ]              
  166.                 Total - sort by total size, largest first.
  167.                 
  168.                 Waste - sort by wasted space, largest first (not as
  169.                 percentage of overall space).
  170.                 
  171.                 Files - sort by number of files, largest first.
  172.                 
  173.                 None - do not sort. This may be useful if you are
  174.                 comparing DirSize's output to an unsorted listing from
  175.                 the DOS DIR command - each directory is displayed in the
  176.                 same order it was retrieved from disk.
  177.               
  178. -p            Do not paginate the output. Pagination pauses after each
  179.               screenful of output. [Enter] shows the next line, [Esc]
  180.               exits, [End] scrolls continuously to the end of the output,
  181.               and any other key shows the next screen full of output.
  182.               Pagination is automatically disabled when the output is
  183.               redirected.
  184.               
  185. -size=#       Only show directories that use # space or larger. A K, M or
  186.               G suffix can be used to express the value in KBytes (1024
  187.               bytes), MBytes (1024 KBytes) or GBytes (1024 Mbytes). This
  188.               is very useful for finding network space hogs, or for
  189.               eliminating small directories that are of no consequence
  190.               from the display.
  191.               
  192. -cl=#         Show how much disk space would be wasted if the cluster size
  193.               was set to # bytes per cluster. # is restricted by DOS to
  194.               powers of two, but for convenience DirSize allows it to be
  195.               set to any value. This is useful for previewing the result
  196.               of a change in cluster size on a set of files. In general,
  197.               the smaller the cluster size, the smaller the wasted space.
  198.               As for -size=# above, a K, M or G suffix can be used.
  199.               
  200. -dir          In this mode, DirSize does not round up the space used by
  201.               each directory (the local size, not including any
  202.               subdirectories). DirSize also ignores the space used in each
  203.               directory by DOS for housekeeping.
  204.               
  205. -#            Default: All levels (255)
  206.               
  207.               Limits the number of levels of directories displayed to the
  208.               given value. Eg -1 will only show the first directory level.
  209.               The statistics will include all levels, but they will not be
  210.               displayed. This is very useful if you just need to find out
  211.               how much total space is in use by an application without
  212.               caring how it is divided into sub-directories. A value of 0
  213.               is equivalent to a value of 255 (i.e. all levels).
  214.               
  215. -comma        Print the result in a comma-delimited output format suitable
  216.               for importing into a spreadsheet, database or word
  217.               processor.
  218.               
  219. -tab          Same as -comma above but outputs in tab-delimited format.
  220.               
  221. -nowaste      Do not show wasted space for each directory. The wasted
  222.               space is still included in the totals - it is just not shown
  223.               as a display column.
  224.               
  225. -nostats      Disable the drive statistics shown at the end of the report.
  226.               
  227. -asval        Show the actual wasted space per directory rather than as a
  228.               percentage of the directory's used space.
  229.               
  230. -c<+|->       Control which characters to use for drawing lines.
  231.               
  232.               + Uses DOS's graphical line drawing characters even if it
  233.               detects that its output is being redirected.
  234.               - Uses portable text line drawing characters even if it
  235.               detects that its output is not being redirected. This is
  236.               useful if the result is going to be used on another
  237.               computer, for example, on a Unix machine or a Macintosh.
  238.               
  239.               Note: When DirSize detects that its output is being
  240.               redirected, it automatically turns off pagination, and
  241.               selects portable characters to draw lines, such as +, - and
  242.               |. It does this because the output may be sent to a device
  243.               or another computer that does not understand DOS's line
  244.               drawing characters (which are non-portable). When DirSize's
  245.               output goes to the screen, it uses the DOS line drawing
  246.               characters. You can override the default behaviour in either
  247.               case using the -c option
  248.  
  249.  
  250. DirSize Environment Variable
  251. ============================
  252.  
  253. If you regularly use the same settings for DirSize, you can set them in
  254. the environment variable DirSize. This variable is processed before
  255. command line options, so anything specified on the command line will
  256. override it.
  257.  
  258. e.g.
  259.  
  260.    SET DIRSIZE=-nowaste -c- -nosort
  261.  
  262. Some of DirSize's command line options require an equals sign. In order to
  263. use these in an environment variable, change the equal sign (=) to a colon
  264. (:) eg -cl=# becomes -cl:#.
  265.  
  266.  
  267. Redirecting Output
  268. ==================
  269.  
  270. DirSize's output can be redirected to any device. For example, to save
  271. DirSize's output to the file output.txt, you can type:
  272.  
  273.    dirsize > output.txt    [Enter]
  274.  
  275. To add DirSize output to an existing file exists.txt, type
  276.  
  277.    dirsize >> exists.txt    [Enter]
  278.  
  279. To send DirSize's output to the printer, type
  280.  
  281.    dirsize > prn    [Enter]
  282.  
  283.  
  284. DirSize Example
  285. ===============
  286.  
  287. The output below was generated from running DirSize in the Program Files
  288. directory (in a DOS shell under Windows 95). All directories smaller than
  289. 2 MB have been removed from display:
  290.  
  291.    c:\> dirsize d:\ -2    [Enter]
  292.    DirSize v3.3  Copyright (c) 1993-8 Simon Carter for Crystal Software
  293.    
  294.     Total-no subs  Wstd  Files  Directory name   [dir + subdirs total]
  295.    --------------  ----  -----  -----------------------------------------
  296.                 0    0%      0  D:\   [239,828,992]
  297.             4,096   92%      0  |--Games   [157,437,952]
  298.           593,920   13%     19  |  |--Larry1
  299.           946,176    4%     11  |  |--Larry2
  300.           913,408   24%     52  |  |--Lemmings
  301.        28,327,936    5%    362  |  |--Mech2 ...   [63,311,872]
  302.         1,024,000    7%     17  |  |--Quake ...   [19,726,336]
  303.         9,408,512    3%     67  |  |--Starcon2
  304.        61,587,456    1%    226  |  |--Starcon3
  305.           946,176    5%     10  |  +--Zork
  306.             4,096   95%      0  |--Installation Zips   [69,320,704]
  307.         5,595,136    0%      1  |  |--cardshop
  308.         6,418,432    0%      5  |  |--Driver disks for '95
  309.        56,303,616    0%     56  |  |--Osr2
  310.           999,424   12%     33  |  +--Powerup
  311.         2,920,448    1%      4  |--Recycled
  312.         6,676,480    2%     38  +--zips   [10,149,888]
  313.         3,260,416    3%     20     +--New stuff ...   [3,473,408]
  314.    --------------  ----  -----  -----------------------------------------
  315.       239,828,992    2%    921  Cluster size: 4,096  Wastage: 3,696,755
  316.    --------------  ----  -----  -----------------------------------------
  317.    
  318.    Drive D: statistics:
  319.       Cluster size:          4,096 bytes
  320.         Free space:      6,615,040 bytes (  3% of capacity is free)
  321.         Used space:    238,186,496 bytes
  322.           Capacity:    244,801,536 bytes
  323.  
  324.  
  325. Note how all sizes shown (except the wasted space) are integral (whole)
  326. multiples of the drive's cluster size.
  327.  
  328. When DirSize has produced a display, you can press:
  329.      [W]   To toggle the wastage display on and off
  330.      [D]   To alternate the wastage display format between a percentage of
  331.            the total space used or as an actual value
  332.      [F]   To toggle the file count display on and off
  333.      [A]   Alternates the display of tree characters betweeen standard
  334.            ASCII and graphic line-drawing characters.
  335.  
  336.  
  337.  
  338. What is the "Cluster Size" ?
  339. ============================
  340.  
  341. When your computer places files on a disk (both hard disks and floppy
  342. disks), it must use an integral number of allocation units. The size of
  343. the allocation units varies depending on the total capacity of the disk.
  344. This means that if a file is smaller than one complete allocation unit, it
  345. does not fill the entire allocation unit. For example, lets say we have a
  346. file that is 300 bytes long. On a floppy disk with an allocation unit of
  347. 512 bytes, the file will only occupy the first 300 bytes, but since one
  348. entire allocation unit must be used, the remaining 212 bytes are wasted. A
  349. file 513 bytes long will occupy 2 allocation units, with 511 bytes wasted.
  350. An allocation unit is called a CLUSTER. Floppy drives typically use a
  351. cluster size of 512 bytes or 1,024 bytes, so not much space is wasted.
  352. Hard disks range from 2,048 bytes (for a 106 MB drive) to 32,768 bytes
  353. (for a 1.04 GB drive) and even 65,535 bytes, which means that a great deal
  354. of space is wasted. The cluster size gets bigger with bigger disks for two
  355. reasons:
  356.  
  357.    1)    A DOS limitation that sets an absolute upper maximum on the total
  358.          number of clusters on a drive (65535).
  359.    2)    The overhead of managing a large number of clusters consumes a
  360.          lot of disk space that cannot be used for anything else.
  361.  
  362. The DOS DIR command always shows you the size actually in use by the file
  363. - it does not include the extra 'wasted' space at the end of the cluster.
  364. This wasted space is sometimes referred to as 'slack' space.
  365.  
  366.  
  367. Directories use up clusters too
  368. ===============================
  369.  
  370. DirSize takes into account the amount of disk space used to store the
  371. entries within each directory. Normal file, directory and volume label
  372. entries take up 32 bytes each. Long filename entries can consume between 1
  373. and 32 additional directory entries (each of 32 bytes).
  374.  
  375. Even empty directories use a minimum of one cluster - for the current
  376. directory "." and the parent directory ".." entries. The root directory
  377. always consumes a fixed and pre-determined amount of disk space which
  378. cannot be reclaimed, and DirSize excludes the number of entries in the
  379. root directory from its calculations.
  380.  
  381. DirSize does not take into account the size of entries that are no longer
  382. being used. This means that a directory that has had many files deleted
  383. may display a size lower than that actually in use. DOS never reclaims
  384. this extra space unless you delete the directory.
  385.  
  386. To reduce the amount of disk space used by directories, remove directories
  387. that do not contain any files. Also, if you delete a large number of files
  388. from one directory (particularly directories containing long filenames),
  389. move the files to a new directory, remove the old one and then rename the
  390. new directory to the original name.
  391.  
  392.  
  393. Lost clusters
  394. =============
  395.  
  396. Clusters can become orphaned when DOS is unable to complete changes to the
  397. disk, for example, when you are forced to reboot your machine or when the
  398. power is turned off accidentally. These clusters cannot be used until they
  399. are identified and reclaimed. Use the DOS CHKDSK or SCANDISK command to
  400. reclaim lost clusters. Lost clusters are considered to be used.
  401.  
  402.  
  403. Reducing wasted space
  404. =====================
  405.  
  406.  
  407. What about Disk Compression ?
  408. =============================
  409.  
  410. Disk compression programs like Stacker and DoubleSpace are able to make
  411. use of the wasted space because they take on the responsibility of storing
  412. the files themselves. By doing so, they overcome DOS's integral cluster
  413. size limitation. DirSize's space wasted information may be invalid on
  414. volumes controlled by these programs, and on some later versions of file
  415. servers.
  416.  
  417.  
  418. What about archives ?
  419. =====================
  420.  
  421. Storing collections of files in a compressed or uncompressed archive saves
  422. space, because by grouping all of the files into one large file, only a
  423. small amount of space is wasted. The archive program uses its own format
  424. to store the files without wasting space.
  425.  
  426.  
  427. Partitions - decreasing the cluster size
  428. ========================================
  429.  
  430. Partitions subdivide a physical disk drive into a number of logical
  431. drives. For example, a 500 MB hard disk could be partitioned into two
  432. 250MB partitions, C: and D:. The advantage of doing this is that the
  433. cluster size can be smaller, and in general, the amount of wasted space
  434. will be smaller. The disadvantage is that it takes time to set up (since
  435. you have to move ALL of your data off the hard disk in order to partition
  436. it, unless you have a program that can re-partition on the fly), and you
  437. have to remember which drive your programs are on, and manage space across
  438. two drives instead of one. For more information on partitions, see the DOS
  439. FDISK command.
  440.